Virtual Magnifying Glass
Source Code

Index

About Virtual Magnifying Glass ................................... page 1
Licence .......................................................... page 1
Compiling the software ........................................... page 2
Description of the files ......................................... page 3
Authors .......................................................... page 4

About Virtual Magnifying Glass

	Virtual Magnifying Glass is designed for visually-impaired and others who need to magnify a part of the screen. Unlike most similar programs it does not open a separate window for the magnification but instead puts a movable magnifying glass on screen.

	This software is the multiplatform version of Virtual Magnigying Glass. This release is experimental and any feedback you can give us about it will be greatly appreciated and can greatly enhance the quality of the software. You can give us feedback on our source-forge page: http://sourceforge.net/projects/magnifier

	The currently supported platforms are:

•	Windows (95 or superior)
•	Linux, distribution independent

	Planned platforms are:

•	Mac OS X
•	Pocket PC with Windows CE

Licence

	Virtual Magnifying Glass is free software; you can redistribute it and/or modify it under the
terms of the GNU General Public License version 2 as published by the Free Software Foundation.

	Virtual Magnifying Glass is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

	Please note that the General Public License version 2 does not permit incorporating Virtual Magnifying Glass into proprietary programs.

Compiling the software

	This program is written in Object Pascal, or object-oriented pascal. Pascal is a strong-typed, structured programming language.

	This source code can be compiled either using Lazarus, a RAD IDE for the Free Pascal Compiler, or using Borland Delphi.

On Windows:

	The software compiles well with both Borland Delphi 5 and 7, and perhaps other versions too. If you experience trouble compiling with Borland Delphi 5 it may be due to the Unix line-endings utilized. You can fix this by running the unix2dos GNU software on the .pas files. This software is available on many platforms, including Windows. No special configurations are required to compile the project.

	To compile the project with Lazarus you will need a very recent Lazarus (version 0.9.12 or newer) and you will need to recompile your LCL with the option -dPassWin32MessagesToLCL

	After this is ready, just open the .lpi project file and compile.

On Linux:

	On Linux you will need a very recend Lazarus (version 0.9.12 or newer).

Description of the files

Source code:
	
	This files contain pascal code for the Virtual Magnifying Glass.

app.pas
glass.pas
magnifier.dpr
appsettings.pas
constants.pas
app.dfm
systray.pas

	This files contain pascal code for the cross-platform tray icon component.

trayicon.pas
wstrayicon.pas
wscommontrayicon.pas
wswin32trayicon.pas
wsgtk2trayicon.pas
wsgtktrayicon.pas
wsqttrayicon.pas

Build and Install scripts:
	
	Script files to easely compile and install the software.

Makefile
install.sh
make.sh				----  Builds the magnifier
clean.sh				----  Removes all files generated when building the magnifier

Resource files:
	
	This files are used for generating the .res resource file used by the program on Windows. Some of them are used on *nix by the software and others do nothing on this platform.

bottom.bmp
bottomleft.bmp
bottomright.bmp
left.bmp
right.bmp
top.bmp
topleft.bmp
topright.bmp
compile with windres.bat
compile with brcc32.bat
resource.h
icon1.ico
icon2.ico
icon3.ico
lente.res
magnifier.lrs
magnifier.rc

Package scripts:
	
	Under the “build” directory you can find build scripts capable of generating redistributable packages for the users.

build/
	build_package.sh		----  Generates .tar.bz2 packages
	magnifier.spec		----  RPM spec file. Use Emacs to build a RPM from it.

Documentation:
	
	Under the “docs” directory you can find manuals on various languages and for various operating systems.

docs/freebsd/
	README-EN.pdf
	README-EN.rtf
	README-PT.pdf
	README-PT.rtf
docs/linuxgtk1/
	README-EN.pdf
	README-EN.rtf
	README-PT.pdf
	README-PT.rtf
docs/linuxgtk2/
	README-EN.pdf
	README-EN.rtf
	README-PT.pdf
	README-PT.rtf

Authors

•	Chris O'Donnell
•	Felipe Monteiro de Carvalho
•	Harri Pyy